home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / munmap.z / munmap
Encoding:
Text File  |  2002-10-03  |  4.6 KB  |  132 lines
  1.  
  2.  
  3.  
  4. mmmmuuuunnnnmmmmaaaapppp((((2222))))                                                            mmmmuuuunnnnmmmmaaaapppp((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_uuuu_nnnn_mmmm_aaaa_pppp - unmap pages of memory
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_mmmm_mmmm_aaaa_nnnn_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _mmmm_uuuu_nnnn_mmmm_aaaa_pppp_((((_vvvv_oooo_iiii_dddd _****_aaaa_dddd_dddd_rrrr_,,,, _ssss_iiii_zzzz_eeee______tttt _llll_eeee_nnnn_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The function _mmmm_uuuu_nnnn_mmmm_aaaa_pppp removes the mappings for pages in the range [_a_d_d_r,
  18.      _a_d_d_r + _l_e_n).  Further references to these pages will result in the
  19.      delivery of a _SSSS_IIII_GGGG_SSSS_EEEE_GGGG_VVVV signal to the process.
  20.  
  21.      If the region being detached via _mmmm_uuuu_nnnn_mmmm_aaaa_pppp(2) belongs to a shared address
  22.      space, and I/O is being done to this range by a process belonging to the
  23.      same shared group, _mmmm_uuuu_nnnn_mmmm_aaaa_pppp(2) would fail returning _EEEE_BBBB_UUUU_SSSS_YYYY.  The specified
  24.      virtual address range would not be unmapped from the shared address space
  25.      unless it spans multiple contiguous regions in which case part of the
  26.      address range (before the region causing the error) may be unmapped
  27.      before _EEEE_BBBB_UUUU_SSSS_YYYY is returned.
  28.  
  29.      The function _mmmm_mmmm_aaaa_pppp often performs an implicit _mmmm_uuuu_nnnn_mmmm_aaaa_pppp.
  30.  
  31.      Note that when _mmmm_uuuu_nnnn_mmmm_aaaa_pppp is called by a process which is a member of a
  32.      shared process group, the unmapping operation is relatively more
  33.      expensive than it is for an independent process.  This is because the
  34.      _mmmm_uuuu_nnnn_mmmm_aaaa_pppp system call must synchronize the removal of the address space with
  35.      the other processes in the share group.  Refer to the _ssss_pppp_rrrr_oooo_cccc(2) manual
  36.      entry for more information on shared process groups.
  37.  
  38. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  39.      On success, _mmmm_uuuu_nnnn_mmmm_aaaa_pppp returns _0000; on failure, _mmmm_uuuu_nnnn_mmmm_aaaa_pppp returns _----_1111 and sets
  40.      _eeee_rrrr_rrrr_nnnn_oooo to indicate an error.
  41.  
  42. EEEERRRRRRRROOOORRRRSSSS
  43.      Under the following conditions, the function _mmmm_uuuu_nnnn_mmmm_aaaa_pppp fails and sets _eeee_rrrr_rrrr_nnnn_oooo
  44.      to:
  45.  
  46.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL _a_d_d_r is not a multiple of the page size as returned by _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff.
  47.  
  48.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL Addresses in the range [_a_d_d_r, _a_d_d_r + _l_e_n) are outside the valid
  49.             range for the address space of a process.
  50.  
  51.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL The argument _l_e_n has a value less than or equal to _0000.
  52.  
  53.      _EEEE_BBBB_UUUU_SSSS_YYYY  The address range specified has some active _IIII_////_OOOO initiated by some
  54.             other process belonging to same share group.
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. mmmmuuuunnnnmmmmaaaapppp((((2222))))                                                            mmmmuuuunnnnmmmmaaaapppp((((2222))))
  70.  
  71.  
  72.  
  73. SEE ALSO
  74.      _mmmm_mmmm_aaaa_pppp(2), _ssss_iiii_gggg_nnnn_aaaa_llll(2), _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff(3C).
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.